package com.ruoyi.campus.service;

import com.ruoyi.campus.domain.SchoolInfo;

import java.util.List;

/**
 * 学校信息Service接口
 * 
 * @author campus-alarm
 * @date 2024-01-01
 */
public interface ISchoolInfoService 
{
    /**
     * 查询学校信息
     * 
     * @param schoolId 学校信息主键
     * @return 学校信息
     */
    SchoolInfo selectSchoolInfoBySchoolId(Long schoolId);

    /**
     * 查询学校信息列表
     * 
     * @param schoolInfo 学校信息
     * @return 学校信息集合
     */
    List<SchoolInfo> selectSchoolInfoList(SchoolInfo schoolInfo);

    /**
     * 查询学校信息详情（包含统计数据）
     * 
     * @param schoolId 学校主键
     * @return 学校信息
     */
    SchoolInfo selectSchoolInfoWithStatistics(Long schoolId);

    /**
     * 根据学校编码查询学校信息
     * 
     * @param schoolCode 学校编码
     * @return 学校信息
     */
    SchoolInfo selectSchoolInfoByCode(String schoolCode);

    /**
     * 根据用户ID查询用户所属学校
     * 
     * @param userId 用户ID
     * @return 学校信息
     */
    SchoolInfo selectSchoolInfoByUserId(Long userId);

    /**
     * 查询启用状态的学校列表
     * 
     * @return 学校信息集合
     */
    List<SchoolInfo> selectActiveSchoolList();

    /**
     * 根据地理位置查询附近的学校
     * 
     * @param latitude 纬度
     * @param longitude 经度
     * @param distance 距离（公里）
     * @return 学校信息集合
     */
    List<SchoolInfo> selectSchoolsByLocation(Double latitude, Double longitude, Double distance);

    /**
     * 新增学校信息
     * 
     * @param schoolInfo 学校信息
     * @return 结果
     */
    int insertSchoolInfo(SchoolInfo schoolInfo);

    /**
     * 修改学校信息
     * 
     * @param schoolInfo 学校信息
     * @return 结果
     */
    int updateSchoolInfo(SchoolInfo schoolInfo);

    /**
     * 批量删除学校信息
     * 
     * @param schoolIds 需要删除的学校信息主键集合
     * @return 结果
     */
    int deleteSchoolInfoBySchoolIds(Long[] schoolIds);

    /**
     * 删除学校信息信息
     * 
     * @param schoolId 学校信息主键
     * @return 结果
     */
    int deleteSchoolInfoBySchoolId(Long schoolId);

    /**
     * 校验学校编码是否唯一
     * 
     * @param schoolInfo 学校信息
     * @return 结果
     */
    String checkSchoolCodeUnique(SchoolInfo schoolInfo);

    /**
     * 启用/停用学校
     * 
     * @param schoolId 学校ID
     * @param status 状态
     * @return 结果
     */
    int changeSchoolStatus(Long schoolId, Integer status);

    /**
     * 批量更新学校状态
     * 
     * @param schoolIds 学校ID列表
     * @param status 状态
     * @return 结果
     */
    int updateSchoolStatusBatch(Long[] schoolIds, Integer status);

    /**
     * 导入学校信息数据
     * 
     * @param schoolList 学校信息列表
     * @param isUpdateSupport 是否更新支持，如果已存在，则进行更新数据
     * @param operName 操作用户
     * @return 结果
     */
    String importSchool(List<SchoolInfo> schoolList, Boolean isUpdateSupport, String operName);
} 